home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / commodity / opaquemove / docs-txt / english / opaque-ui.txt < prev    next >
Text File  |  1997-04-26  |  9KB  |  265 lines
  1.  
  2.  
  3. Title: OpaqueMove User Interface
  4.  
  5.  
  6. User Interface
  7.  
  8. MUI
  9.  
  10. The OpaqueMove user interface is written using the MUI object library. For
  11. information on using MUI programs, see the MUI documentation.
  12.  
  13. MUI is a much more powerful UI system than Gadtools, and as you can see if
  14. you are viewing this page on a screen with at least 32 free colormap entries,
  15. it also looks a lot nicer. It is almost endlessly customizable.
  16.  
  17. It is recommended that you register MUI. It is not expensive, and well worth
  18. the small cost.
  19.  
  20. Back to Top
  21.  
  22. Save/Use/Cancel
  23.  
  24. [Save/Use/Cancel Image]
  25.  
  26. The Save button will close the UI window and save the current preferences
  27. settings to ENVARC:OpaqueMove/Opaque.Prefs and ENV:OpaqueMove/Opaque.Prefs.
  28.  
  29. The Use button will close the UI window and save the current preferences
  30. settings only to ENV:OpaqueMove/Opaque.Prefs.
  31.  
  32. The Cancel button will close the UI window and re-load the last set of
  33. preferences saved to ENV:OpaqueMove/Opaque.Prefs, which will cancel any
  34. changes since the last Save or Use.
  35.  
  36. Back to Top
  37.  
  38. Move/Size Preferences
  39.  
  40. [Move/Size Window Image]
  41.  
  42. This is the movement preferences window; the size preferences window looks
  43. similar. This window allows you to set various preferences related to which
  44. windows are or are not moved opaquely.
  45.  
  46. Allow Screen
  47.      An AmigaOS wildcard pattern. The screen title of the current screen must
  48.      match this pattern before any windows on the screen may be moved
  49.      opaquely.
  50.  
  51. Allow Window
  52.      Similar to Allow Screen but a matter which window titles must match
  53.      before the window may be moved opaquely.
  54.  
  55. Deny Screen
  56.      Similar to Allow Screen, but any windows on a screen matching this
  57.      pattern will not be moved opaquely.
  58.  
  59. Deny Window
  60.      Counterpart to Allow Window.
  61.  
  62. Screen Depths
  63.      A window's containing screen depth must be checked in this list before
  64.      the window may be moved opaquely. This is useful for non-graphics card
  65.      screens where some bit depths may be very slow to render graphics. On
  66.      modern graphics cards under the CyberGfx system, this makes little
  67.      difference.
  68.  
  69.      New to V2.3: the EGS/AGA gadgets control the operation on native screen
  70.      modes, and the new CyberGfx 8, 16, and 24 bit selections are used to
  71.      control CyberGfx screenmodes.
  72.  
  73. Max Windows
  74.      Since screens with many windows may be slow, this is a limit for how
  75.      many windows the screen may contain before opaque movement is turned
  76.      off.
  77.  
  78. Max WinX
  79.      Since large windows may be slow to move on some graphics devices,
  80.      windows larger than this width will by moved by outline.
  81.  
  82. Max WinY
  83.      Similar to Max WinX but for height instead of width.
  84.  
  85. Refresh Simple
  86.      On most graphics devices, simple refresh windows are faster to move than
  87.      smart refresh. If this button is checked, simple refresh windows may be
  88.      moved opaquely.
  89.  
  90. Refresh Smart
  91.      Under standard Intuition, smart refresh windows can be very slow to
  92.      move. This gadget may be toggled off to stop smart refresh windows from
  93.      being moved opaquely. Note that the qlayers patch may be installed to
  94.      speed up movement of smart refresh windows, in which case it might be
  95.      practical to check this option.
  96.  
  97. Qualifier
  98.      The qualifier that must be pressed before opaque movement is performed.
  99.      This can be "None" (mostly useful in combination with the Drag Bar
  100.      control option), or you can select from various qualifier keys such as
  101.      shift, control, and so on. There are two sets of Qualifier/Control
  102.      combinations, so you can specify conditions such as "No
  103.      Qualifier/Dragbar, or Control Key/Center.
  104.  
  105. Control
  106.      Specifies the location in which a window must be grabbed before it can
  107.      be moved opaquely. This can be Anywhere (useful with qualifier keys),
  108.      Drag Bar (useful either with or without qualifier keys), Center (useful
  109.      with external size commodities), or Off.
  110.  
  111. Button
  112.      In OpaqueMove 2.2, users of three button mice can use either the left or
  113.      middle mouse buttons to control dragging and sizing operations.
  114.  
  115. The Size preferences window is almost identical to the movement preferences
  116. window, except that the possible control locations are different:
  117.  
  118. Control
  119.      Specifies the location in which a window must be grabbed before it can
  120.      be sized opaquely. This can be Gadget (useful with or without
  121.      qualifiers), Edge/Corner (the window may be grabbed near any edge or
  122.      corner, useful with qualifier keys), Edge (only window edges but not
  123.      corners count), corner (only window corners but not edges count),
  124.      Edge/Corner/Gadget, or Off.
  125.  
  126. Back to Top
  127.  
  128. General Preferences
  129.  
  130. [General Prefs Window Image]
  131.  
  132. This is the general preferences window. It controls various preferences:
  133.  
  134. Global Deny Screen
  135.      Some programs, such as Final Writer, appear not to work correctly with
  136.      OpaqueMove. Any screen or window matching this pattern will not be moved
  137.      either by outline or opaquely by OpaqueMove.
  138.  
  139. Global Deny Window
  140.      Similar to Global Deny Screen but for windows.
  141.  
  142. Border Width
  143.      This controls the border width for the "Center" drag location, and the
  144.      edge & corner widths for the associated size locations. For example, if
  145.      you are using Edge/Corner sizing, then you must grab the window closer
  146.      than this many pixels to an edge or corner.
  147.  
  148. Key File
  149.      This is the location of your OpaqueMove key file. Without a registered
  150.      key file, the program is fully functional, but there is a shareware
  151.      requester presented at start time, and the "About" menu will list the
  152.      program as unregistered.
  153.  
  154. Brush Dir
  155.      This is the directory that contains the custom IFF brushes that will be
  156.      used if the Custom Cursors option is checked. The brush names under this
  157.      directory are always fixed:
  158.  
  159.      Brush.Move
  160.      Brush.Size_LF
  161.      Brush.Size_RT
  162.      Brush.Size_UP
  163.      Brush.Size_DN
  164.      Brush.Size_UPLF
  165.      Brush.Size_UPRT
  166.      Brush.Size_DNLF
  167.      Brush.Size_DNRT
  168.  
  169.      There is one cursor for window movement, and 8 for sizing (one for each
  170.      corner, and one for each edge). Brushes must be 2 plane IFF files, with
  171.      a GRAB chunk to indicate the cursor hotspot. Transparent colors and so
  172.      on depend on your specific graphics device.
  173.  
  174.      OpaqueMove includes two sets of cursors. The Shadowed set assumes that
  175.      Color 0 is transparent, color 1 is the primary cursor color, color 2 is
  176.      also transparent, and color 3 is a dark shadow color (usually black).
  177.      This is an appropriate scheme for most Amiga graphics card, and the
  178.      colors may be set in the Sys:Prefs/Pointer program. They will not be
  179.      changed by OpaqueMove. The Flat set uses only color 1.
  180.  
  181. Custom Cursors
  182.      If this is checked, OpaqueMove will use the custom cursors from BrushDir
  183.      will be used for movement or sizing. All of the supplied cursors have
  184.      been designed to look good in high res mode on graphics cards (set with
  185.      the sys:Prefs/Pointer program), when pointer color 1 is bright, and
  186.      color 3 is black.
  187.  
  188. Show Size/Pos Win
  189.      If this is checked, a small window showing the current size and location
  190.      of the window being moved or sized is shown, like this:
  191.  
  192.      [Size/Pos Window Img]
  193. Friendly Layers Lock
  194.      Not yet functional.
  195.  
  196. Hide Win on Start
  197.      If this is checked, then OpaqueMove will start iconified. Note that an
  198.      unregistered OpaqueMove will not do this, since it always displays the
  199.      registration requestor at startup. But this will work for registered
  200.      versions. Whether an actual icon is generated depends on the MUI
  201.      configuration set up in MUI preferences (MUI:MUI).
  202.  
  203. Back to Top
  204.  
  205. Menus
  206.  
  207. Project
  208.  
  209. Open...
  210.      This will present a requester from which a previously saved preferences
  211.      file may be loaded.
  212.  
  213. Save
  214.      Identical to the Save button, this will save the current preferences
  215.      settings to ENVARC: and ENV:, but will not close the window.
  216.  
  217. Save As...
  218.      This will present a requestor for saving preferences settings in an
  219.      arbitrary location.
  220.  
  221. About...
  222.      This will display a small window showing the program version,
  223.      registration information, and a few other items.
  224.  
  225. Register...
  226.      This will display the registration window which may be used to generate
  227.      a file to be used for email or postal mail registration. See also
  228.      Registration.
  229.  
  230. Hide
  231.      This will iconify the window. Whether an actual icon is displayed is
  232.      controlled by the MUI preferences.
  233.  
  234. Quit
  235.      This will exit the program.
  236.  
  237. Edit
  238.  
  239. Restore
  240.      This will load the last set of settings from ENV: without closing the
  241.      window.
  242.  
  243. Last Saved
  244.      This will load the last set of settings saved to ENVARC without closing
  245.      the window
  246.  
  247. Settings
  248.  
  249. MUI...
  250.      This will show the MUI preferences window for OpaqueMove.
  251.  
  252. Back to Top
  253.  
  254. Quitting
  255.  
  256. OpaqueMove can be shut down by any of the following methods:
  257.  
  258.    o Sending a control-C signal to the process.
  259.    o Using the Commodities Exchange window to remove the commodity.
  260.    o Selecting Project/Quit from the OpaqueMove menus.
  261.  
  262. Back to Contents
  263. -----------------------------------------------------------------------------
  264.  
  265.